home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-07 / mail15.zip / MANUAL.DOC < prev    next >
Text File  |  1992-03-01  |  42KB  |  1,255 lines

  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.                               Use Agreement
  9.  
  10.             This software may be freely used for non commercial and
  11.        educational purposes. Any programs which use part or all of
  12.        this software must be provided in source form with this
  13.        notice intact except by written permission from James A.
  14.        Littlefield, Littlefield Associates.
  15.  
  16.             If you find MAILROOM useful please register your copy
  17.        by sending $20.00 to the address below.  Registration
  18.        entitles you to source code with extensive comments and
  19.        notification of future enhancements and upgrades.
  20.  
  21.                James A. Littlefield, Jr.
  22.                c/o Dr. James Littlefield
  23.                RR2 Box 88
  24.                Cornish, NH 03745
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.                          Limitation of Liability
  75.  
  76.                This code is made available in the hope it will be useful,
  77.                BUT WITHOUT ANY WARRANTY OF ANY KIND OR LIABILITY FOR ANY
  78.                DAMAGES OF ANY KIND.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.                                 Trademarks
  141.        PROCOMM, PROCOMM Plus, and Intuitive Communications are
  142.        registered trademarks of Datastorm Technologies Inc.
  143.        LANtastic is a registered trademark of Artisoft Corp.
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.                       MAILROOM ver 1.5 Documentation
  207.  
  208.  
  209.        1.   Overview _ - _ What _ MAILROOM _ Can _ Do
  210.  
  211.              The MAILROOM (mailrm.exe) program, its associated
  212.        utilities and PROCOMM Aspect script files are designed to
  213.        provide a solution to electronic mail sharing between remote
  214.        users (via PROCOMM) and network users (via Artisoft's
  215.        LANtastic).  PROCOMM provides a mail system that allows
  216.        remote users to connect and leave mail for other PROCOMM
  217.        users.  LANtastic provides similar features to local area
  218.        network users via the network mail system.  MAILROOM
  219.        provides a linkage between the PROCOMM e-mail system and the
  220.        network mail system.  Remote users can leave mail either for
  221.        other remote users or for network users.  In a similar
  222.        manner, network users can direct mail across the network to
  223.        other net users or (via MAILROOM) to the PROCOMM e-mail
  224.        system where the messages will be picked up by the intended
  225.        recipient remote user the next time they log in.
  226.  
  227.             MAILROOM was developed as an 'add on' utility program
  228.        without explicit support from either Datastorm or Artisoft.
  229.        The basic objectives of the development were to provide
  230.        reasonable functionality with a small program that is easy
  231.        to setup and use.  In keeping with this philosopy, MAILROOM
  232.        requires no user input once it has been invoked.  Screen
  233.        display is fairly brief... MAILROOM provides most of its
  234.        feedback by mailing a status message to the network system
  235.        administrator.  This lack of extensive user interaction
  236.        makes MAILROOM an ideal tool which can easily be embedded in
  237.        batch files or called from other C programs.
  238.  
  239.             MAILROOM has been tested with a LANtastic NOS version
  240.        3.x and 4.0 with both the Artisoft 2Mb adapter cards and
  241.        with third party ethernet cards.  The program has worked
  242.        successfully with PROCOMM and PROCOMM Plus v. 2.01.
  243.  
  244.        1.1   New _ Features _ - _ ver _ 1.4
  245.  
  246.              This version of mailrm.exe provides a number of new
  247.        features and some revisions to the command structure
  248.        designed to increase ease of use and increase compatibility
  249.        with batch files.
  250.  
  251.           - Reduced number of required command line arguments
  252.  
  253.           - Increase number and flexibility of command line
  254.             parameters
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.           - Optional 'status letters' will be mailed to the
  273.             LANtastic user "sysop" if one is found.
  274.  
  275.           - mailrm may be configured to leave 'return receipt' mail
  276.             for PROCOMM users informing them of the data and time
  277.             of mail forwarding onto the network.
  278.  
  279.           - A quite mode has been added. This mode suppresses all
  280.             mailrm generated screen printouts (but will not
  281.             suppress any error messages generated by the NET MAIL
  282.             command).  Generally, provided serious errors are not
  283.             encountered this will allow mailrm to run without
  284.             updating the screen.
  285.  
  286.           - PROCOMM mail system file maint. utilities have been
  287.             included.  Mailrm uses one bit (hopefully unused by
  288.             others) to keep track of which messages have been
  289.             forwarded to the network and which haven't.  Mailrm now
  290.             includes features which allow this bit to be
  291.             set/cleared for ALL messages in the PROCOMM message
  292.             database.
  293.  
  294.        1.2   New _ Features _ - _ ver _ 1.5
  295.  
  296.              Version 1.5 provides several bug fixes and one major
  297.        new feature not present in ver. 1.4.
  298.  
  299.           - MAILROOM Execution Status Messages: Version 1.4
  300.             incorrectly mailed the status messages to network
  301.             userid "SYSOP" instead of looking in the alias file and
  302.             properly resolving the name "SYSOP" to a valid network
  303.             user id.  This has been corrected in v1.5.
  304.  
  305.           - MAILROOM will not generate any status mail messages
  306.             when it runs and does not forward any mail in either
  307.             direction.  This feature was implemented to prevent
  308.             large amounts of essentially useless network mail to
  309.             the sysop in those cases where mailrm is invoked from a
  310.             timed script file.
  311.  
  312.           - If the return receipt option is enabled, private
  313.             messages to network users will cause private return
  314.             receipts to be generated.
  315.  
  316.           - Two aspect script files, automail.asp and auto2.asp,
  317.             have been provided to implement mail forwarding more
  318.             promptly and with less burden on the sysop.  These
  319.             scripts will automatically run mailrm.exe at various
  320.             times depending on the script used and the system
  321.             configuration.  auto2.asp is a very simple script which
  322.             enters PROCOMM host mode and then once host mode is
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.             terminated runs the contents of the DOS batch file,
  339.             mailroom.bat.  Automail.asp is a more complex script
  340.             capable of invoking mailrm.exe both after each caller
  341.             AND at regular time intervals.  In addition to being
  342.             convenient both scripts solve a signficant problem with
  343.             mailrm/PROCOMM interaction.  Since PROCOMM keeps the
  344.             mail database files (pcplus.hdr, pcplus.msg,
  345.             pcplus.usr) open while it is in host mode, any changes
  346.             to the lengths of these files by mailrm can result in
  347.             corrupted mail.  Automail.asp and auto2.asp  only run
  348.             mailrm when PROCOMM is not in host mode and thus avoid
  349.             the problem.  With the capabilities of automail.asp, it
  350.             is no longer necessary for the sysop to manually invoke
  351.             mailrm at specific times.
  352.  
  353.           - Net to Remote Mail Forwarding: This version of mailrm
  354.             adds the ability to forward mail from network users
  355.             onto the PROCOMM mail system.  When invoked with proper
  356.             command line arguments, mailrm will scan the queue
  357.             files on a designated server.  For each valid (non-
  358.             voice) mail file, mailrm will examine the first line of
  359.             the queued file for a special header line containing
  360.             routing information.  If this line is found, the file
  361.             is forwarded to the PROCOMM mail system and deleted
  362.             from the network mail queue.  If the routing
  363.             information in the header line does not identify a
  364.             valid PROCOMM user then an appropriate message is
  365.             returned to the network user who originally sent the
  366.             mail.
  367.  
  368.           - Mail Suppression: Version 1.5ai (and later) allows
  369.             PROCOMM mail to certain users to be suppressed from
  370.             forwarding onto the network.  This feature is useful
  371.             when a remote user has no account on the network but
  372.             should still be able to receive mail from network users
  373.             and also communicate with other remote users via the
  374.             PROCOMM mail system.
  375.  
  376.           - Fewer Required Arguments: Version 1.5b (and later) no
  377.             longer requires a server argument.  When the "-s"
  378.             option is used, mailrm will try to use the selected
  379.             server.  If no server is specified, mailrm will use the
  380.             server name fetched from the network adapter's server
  381.             name table at location 0. Normally this will be the
  382.             first server logged into.  This feature means that
  383.             mailrm can now be run with no command line options
  384.             assuming that the default file names are correct.  Note
  385.             however that running mailrm without any argument will
  386.             forward mail ONLY from the PROCOMM mail system to the
  387.             network.  The "-n" option is still required to perform
  388.             forwarding from the network mail system to the PROCOMM
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.             mail system.
  405.  
  406.  
  407.        2.   GLOSSARY
  408.  
  409.        Remote _ User
  410.  
  411.              A remote user is someone who accesses the electronic
  412.        mail system (and file transfer procedures) via a telephone
  413.        line, modem, and PROCOMM software.  Generally PROCOMM
  414.        assigns a REMOTE USER ID to each remote user to identify
  415.        that user at login and to properly route electronic mail
  416.        to/from that user.
  417.  
  418.         Net _ User
  419.  
  420.              A net user is someone who shares computer resources,
  421.        including electronic mail, via Artisoft's LANtastic local
  422.        area network products.  Each net user also has a network
  423.        user id.  This user id identifies the user at login,
  424.        provides a mechanism for various types of access control,
  425.        and allows proper routing of e-mail among network users.
  426.  
  427.         E-mail
  428.  
  429.              E-mail or Electronic mail is message traffic which is
  430.        transmitted, stored, and viewed electronically.  In general
  431.        each electronic mail item (or message) consists of at
  432.        minimum a sender id (who sent the mail), a recipient id (who
  433.        is to receive the mail), and body text (ie the rest of the
  434.        letter).
  435.  
  436.         Mail _ Server
  437.  
  438.              A mail server is a computer on the LANtastic network
  439.        which maintains the network mail database.  Net users can
  440.        send and receive mail by logging into the mail server and
  441.        invoking various NET commands.  Any network based e-mail
  442.        transactions will involve a mail server.
  443.  
  444.         PROCOMM _ Node
  445.  
  446.              This document identifies the machine running the
  447.        PROCOMM software as the PROCOMM Node.  For successful mail
  448.        forwarding this node must be attached to the LANtastic
  449.        network and must be capable of logging into the mail server.
  450.        The PROCOMM node may be either a workstation, a server, or
  451.        both on the LANtastic network.  It is also possible to have
  452.        the PROCOMM node and the mail server be the same machine.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                   - 8 -
  467.  
  468.  
  469.  
  470.        3.   Files _ Included _ with _ Release _ 1.5c
  471.  
  472.            - mailrm.exe - executable file which performs the mail
  473.             forwarding function
  474.  
  475.           - automail.asp - PROCOMM aspect script file to
  476.             automatically run mailrm.exe after each remote user and
  477.             at preset time intervals
  478.  
  479.           - auto2.asp - Simple PROCOMM aspect script to
  480.             automatically run mailrm.exe after each remote user
  481.  
  482.           - maillst.exe - Support program to create a mail alias
  483.             file template based on the  contents of the PROCOMM
  484.             user database.
  485.  
  486.           - manual.doc - This documentation
  487.  
  488.           - mailroom.bat - Sample batch file.  This batch file
  489.             illustrates the steps necessary to run mailrm.exe and
  490.             is also invoked automatically by the automail and auto2
  491.             scripts.
  492.  
  493.           - sendmail.exe - Utility to assist network users with
  494.             sending mail to PROCOMM users.
  495.  
  496.  
  497.        4.   MAILRM _ Execution _ Environment
  498.  
  499.              Mailrm needs access to a number of resources for proper
  500.        operation.  These resources must be provided by the user
  501.        prior to invoking mailrm.  First all the required files must
  502.        be accessable either in the current directory or by passing
  503.        their path names on the command line.  Mailrm uses the
  504.        LANtastic "NET" command to generate network mail therefore
  505.        this  program must be accessable on the PATH.  If used to
  506.        forward network mail from LANtastic to PROCOMM mail, the
  507.        machine from which mailrm.exe runs must be logged into the
  508.        network mail server.  The userid used to establish this
  509.        login session must have the "A" and "M" privileges to
  510.        successfully manipulate the network mail queues.
  511.  
  512.             The maillst program must be able to access the
  513.        /lantasti.net/system.net/accounts hidden file.  Access to
  514.        this hidden file requires that the server's network control
  515.        directory  be linked to the network node running maillst.
  516.  
  517.             Your computer must have enough RAM to simultaneously
  518.        load mailrm.exe, command.com, and net.exe.  If you are
  519.        planning to use the automail.asp script then sufficient ram
  520.        for PROCOMM must also be available.
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                   - 9 -
  533.  
  534.  
  535.  
  536.        5.   MAILRM _ Command _ Line _ Switchs
  537.  
  538.              The new version of mailrm has a smaller number of
  539.        required arguments.  The defualts can be overridden by
  540.        passing command line switchs.  All command line options
  541.        begin with the "-", minus, character followed by an option
  542.        letter and then possibly a further argument.  Note that
  543.        there must be NO spaces between the leading "-", the option
  544.        letter, and the rest of the option command.  Thus "- s
  545.        amber", "-s amber" are illegal whereas "-samber" is the
  546.        proper method of specifying that node "amber" is to be used
  547.        as a mail server.
  548.  
  549.           - ?
  550.  
  551.                  Print instructions screen
  552.  
  553.           - a<filename>
  554.  
  555.                  Set the PROCOMM/network user name alias file to
  556.             <filename>.  If this option is not provided on the
  557.             command line the default name, "alias.dat", is used.
  558.  
  559.           - h<filename>
  560.  
  561.                  Set the PROCOMM mail message header file to
  562.             <filename>.  If this option is not provided the default
  563.             name, "pcplus.hdr", is used.
  564.  
  565.           - m<filename>
  566.  
  567.                  Set the PROCOMM mail message data file to
  568.             <filename>.  If this option is not provided the default
  569.             name, "pcplus.msg", is used.
  570.  
  571.           - n<filename>
  572.  
  573.                  Enable network to remote mail forwarding.  Mail
  574.             from the queue on the server (specified with the -s
  575.             option) is examined for routing headers and forwarded
  576.             as appropriate.  If the filename argument is included
  577.             with the -n option then this filename is used as file
  578.             containing the valid PROCOMM user ids.  If the filename
  579.             is not given then "pcplus.usr" is used.
  580.  
  581.           - q
  582.  
  583.                  Run in quiet mode.  All MAILRM generated screen
  584.             i/o is inhibited however any error messages generated
  585.             by the NET MAIL commands spawned by mailrm will still
  586.             print onscreen.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                   - 10 -
  599.  
  600.  
  601.  
  602.           - r
  603.  
  604.                  Enable generation of PROCOMM user return receipt
  605.             messages.  The return receipt is a short PROCOMM mail
  606.             message addressed to the remote user who originally
  607.             left the mail.  The body of the return receipt
  608.             identifies the time/date of forwarding and the network
  609.             user name to whom the mail was forwarded.
  610.  
  611.           - s<server name>
  612.  
  613.                  Set the mail server machine name to <server name>.
  614.             NOTE: for versions earlier than 1.5b there is no
  615.             default server name therefore this argument is
  616.             required.  The server name should be entered without
  617.             the initial '\' characters.  In order for mailrm to
  618.             successfully forward mail, the user must be logged in
  619.             to the specified server PRIOR to running mailrm.
  620.             Versions 1.5b and later will verify that you are logged
  621.             into at least one server before attempting forwarding
  622.             operations.  Example "-samber" to set mail server name
  623.             to machine "amberi".
  624.  
  625.           - u#
  626.  
  627.                  This option takes a numeric argument which can be
  628.             composed of the SUM of the following numbers with the
  629.             indicated causes.  (1) inhibit mail forwarding... this
  630.             option will perform all normal mailrm operation
  631.             INCLUDING marking PROCOMM mail as forwarded but will
  632.             not actually generate any network mail.  (2) unforward
  633.             all PROCOMM mail... this option will scan the PROCOMM
  634.             mail database files and mark all mail messages as
  635.             unforwarded (including any return receipts generated by
  636.             a previous invocation of mailrm).  (4) supress status
  637.             mail to sysop.  If the name alias file contains a valid
  638.             network user id for the alias "sysop" then mailrm will
  639.             by default generate a status mail message to this user.
  640.             The status message lists details about any dead letters
  641.             generated as well as a summary statistic showing how
  642.             many letters were forwarded and how many dead letters
  643.             where generated.  This option will suppress the sysop
  644.             mail.
  645.  
  646.  
  647.        6.   Name _ Alias _ File _ Construction
  648.  
  649.              Generally people leaving mail via the PROCOMM mail
  650.        system do not know (or do not use) the same user names as
  651.        the LANtastic user accounts.  It is therefore necessary for
  652.        mailrm to have some way of mapping PROCOMM mail recipient
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                                   - 11 -
  665.  
  666.  
  667.  
  668.        names to valid network user ids.  This is accomplished by
  669.        the network name alias file (default "alias.dat") which
  670.        contains a list of valid LANtastic user id names.  Following
  671.        the net user name is a space separated list of valid
  672.        alternate names or alias names for that user.  Consider the
  673.        following sample alias.dat file
  674.  
  675.                        JAL littlefield jimbo jlittlefield
  676.                        MANAGER sysop big_cheese
  677.                        NOFWD curt sandy grimes
  678.  
  679.        Two valid network users are listed: JAL and MANAGER.
  680.        PROCOMM mail addressed to "jimbo", "jal",  etc will all be
  681.        sent to net user id JAL.  PROCOMM mail addressed to
  682.        "big_cheese" will be sent to net user id MANAGER.  Note that
  683.        since "sysop" is also included in MANAGER's alias list, this
  684.        userid will also receive any status mail messages generated
  685.        by mailrm.
  686.  
  687.             Unfortunately, mailrm's string matching abilities are
  688.        quite limited (this may be improved in a future release).
  689.        All comparisons are insensitive to case so "bob" and "BOB"
  690.        are considered equivalent.  An EXACT match between the
  691.        PROCOMM recipient name and an alias name is required.  Any
  692.        PROCOMM mail for which no valid network user name is found
  693.        is mailed to user "deadletter" unless the sysop has
  694.        established a NOFWD entry for that userid (See following
  695.        section).  By default mail is also sent to "sysop" (if
  696.        available) indicating that a dead letter has been generated.
  697.  
  698.        6.1   Alias.dat _ NOFWD _ Option
  699.  
  700.              As illustrated in the sample alias.dat file above,
  701.        Mailrm (ver 1.5 and later) recognizes the special characters
  702.        "NOFWD" in the network userid field of the alias file.
  703.        PROCOMM mail which has a recipient name which is mapped to
  704.        the NOFWD net userid will not be forwarded onto the network.
  705.        The primary use for this capability is to prevent generation
  706.        of erroneous "deadletters" when PROCOMM users who do not
  707.        have network userids send/receive mail.  Since mailrm
  708.        searchs the name alias file from the top down, it is
  709.        suggested that the NOFWD entries be placed at the end of the
  710.        alias file.  This will ensure that all valid network userids
  711.        are examined for forwarding prior to processing of the NOFWD
  712.        entries.
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                   - 12 -
  731.  
  732.  
  733.  
  734.        7.   Network _ to _ Remote _ User _ Mail _ Operations
  735.  
  736.              With MAILROOM 1.5 network users can send mail to remote
  737.        users.  This operation is accomplished by using the normal
  738.        LANtastic mail facilities.  To provide routing and other
  739.        information the first line in the message file must conform
  740.        to the following format.
  741.  
  742.        !remote!<privacy character>!<remote user name>!<comment>
  743.  
  744.        Note the the "<>" are not part of the actual string and
  745.        should not be typed.  The privacy control character
  746.        determines whether the message is forwarded as a PROCOMM
  747.        private message or not.  If this character is set to "p" or
  748.        "P" the message is private.  Any other character will
  749.        generate a non-private message.  The remote user name is
  750.        case insensitive and is used to determine which remote user
  751.        id the message will be mailed to.  PROCOMM is very
  752.        particular about the format of the remote user id therefore
  753.        mailrm will attempt to ensure an exact match (except for
  754.        case) between the remote user name and a valid remote userid
  755.        as contained in the PROCOMM user id file (usually
  756.        pcplus.usr).  Generally the required format will be
  757.        "firstname lastname" (ie exactly one space between the users
  758.        first and last names).
  759.  
  760.             Each time mailrm is invoked with the -n option the
  761.        network queues on the server specified with the -s option
  762.        will be scanned for queued mail files.  Each valid mail file
  763.        will be examined for a properly formatted remote routing
  764.        string on the first line.  If this line is found the file
  765.        will be forwarded and deleted from the queue.  If the file
  766.        cannot be forwarded it will not be deleted from the queue
  767.        and in addition a network mail message will inform the
  768.        sender of the addressing error.
  769.  
  770.  
  771.        8.   Support _ Utilities
  772.  
  773.         8.1   Maillst _ Program
  774.  
  775.              This release includes a utility program, maillst.exe,
  776.        which is designed to assist in setting up or maintaining the
  777.        PROCOMM/network user name mapping file required by
  778.        mailrm.exe.  Maillst.exe must be invoked with two arguments:
  779.        1) the file name of the network name alias file and 2) the
  780.        name of the LANtastic system user accounts file.  Usually
  781.        the LANtastic user account information is contained in the
  782.        file /lantasti.net/system.net/accounts (assuming the
  783.        LANtastic default installation names have been used).  The
  784.        program will scan the user accounts file making sure that
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                   - 13 -
  797.  
  798.  
  799.  
  800.        each LANtastic user name appears in the name alias file.
  801.        LANtastic user names which have no corresponding entry in
  802.        the alias file are appended to the alias file (but no alias'
  803.        are provided).  The sysop still has to edit the alias file
  804.        to define any appropriate pseudonyms for the new network
  805.        user names.
  806.  
  807.        8.2   automail.asp _ Script
  808.  
  809.              As noted previously, this aspect script file is
  810.        designed to automate the mail forwarding function.  The
  811.        script is written to run mailrm both at periodic intervals
  812.        and after each remote user terminates their session.  In
  813.        addition to lowering the sysop's workload this script
  814.        provides  more timely  mail forwarding and makes sure that
  815.        mailrm doesn't execute while PROCOMM is in host mode.
  816.  
  817.             To configure the script for your system two
  818.        modifications are necessary.  Using a text editor (in non-
  819.        document mode) modify the script variables INTERVAL and
  820.        "batchname" as appropriate for your system.  The string
  821.        variable, batchname, contains the name of a DOS batch file
  822.        which will be invoked by the script.  You can enter any name
  823.        you want or simply use the default name, mailroom.bat.  A
  824.        sample mailroom.bat file is included in the mailrm
  825.        distribution archive.  INTERVAL specifies the number of
  826.        seconds between time based executions of the batch file.  If
  827.        this value is set to 0, the batch file will be invoked only
  828.        after each PROCOMM caller.  Once you have adjusted these
  829.        parameters, compile the script using PROCOMM's aspcomp.exe
  830.        utility.  Now you can start PROCOMM and automatically
  831.        execute the script by entering "pcplus /fautomail".
  832.  
  833.             For proper operation of this script the CD line of your
  834.        modem MUST be properly controlled by the modem (or external
  835.        computer if using a hardwired connection).  The script uses
  836.        the assertion of the CD line to detect a connection
  837.        therefore CD should be set to follow the state of the
  838.        carrier.
  839.  
  840.        8.3   Sendmail.exe _ Utility
  841.  
  842.              Routing of mail messages from the network mail system
  843.        to the PROCOMM mail system requires that certain addressing
  844.        information be on the first line of the message.  To assist
  845.        non-technical users with net to remote mail operations the
  846.        sendmail.exe utility has been provided.  This program will
  847.        collect all the required addressing information plus the
  848.        body of the message and will then automatically create the
  849.        necessary addressing line and network mail item.  Addressing
  850.        information is collected from the program's command line
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                                   - 14 -
  863.  
  864.  
  865.  
  866.        arguments and/or from the user during an interactive
  867.        session.  If no command line options are provided, the user
  868.        must enter the remote user id, whether the message is
  869.        private or not, a comment field, and the message text.
  870.        Based on this information, sendmail.exe will generate a net
  871.        e-mail item containing the necessary addressing line.  At
  872.        the other extreme sendmail may be invoked with enough
  873.        command line options to fully specify the mail item.  In
  874.        this case no interactive session is required.  As with
  875.        mailrm, the user must have established a login to the mail
  876.        server machine prior to running sendmail.
  877.  
  878.             Two command line options allow more detailed control
  879.        over sendmail's operation.  The "-uid" option allows a user
  880.        to cause mail outbound to remote users to be mailed to a
  881.        specified network user.  If this option is not used,
  882.        sendmail will send all outbound mail to network user
  883.        "MAILROOM".  The second option, "-server", allows you to
  884.        specify a specific network server to receive the mail
  885.        item(s).  In the absence of the server option, sendmail will
  886.        use the server to which a login session was first
  887.        established.
  888.  
  889.  
  890.        9.   Installation _ Procedures
  891.  
  892.              This section outlines the general steps necessary to
  893.        install and use mailrm's e-mail forwarding capabilities.
  894.        Each step is described in general terms and where
  895.        appropriate an example is given.
  896.  
  897.        9.1   PROCOMM/LANtastic _ Mail _ Installation _ and _ Test
  898.  
  899.              Prior to attempting installation of the MAILROOM
  900.        programs and scripts you must successfully install the
  901.        PROCOMM software and the LANtastic network system.  Since it
  902.        is quite difficult to debug/test several things at one time,
  903.        be sure to fully test the network mail system and PROCOMM
  904.        operation individually BEFORE trying to run MAILROOM.  If
  905.        you cannot send and receive e-mail over the network or
  906.        connect to the PROCOMM network node via a telephone line
  907.        then MAILROOM will surely fail.
  908.  
  909.        9.2   Unpacking _ the _ files
  910.  
  911.              All the relevant files are included in a single
  912.        archive, mailrm15.arc.  Since you are reading this file you
  913.        must have already unpacked the archive.  Although the mailrm
  914.        executables, datafiles, and scripts can reside anywhere on
  915.        your hard disk, most users find it convenient to place these
  916.        files in the same directory where the PROCOMM files have
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                   - 15 -
  929.  
  930.  
  931.  
  932.        been installed (default cplus).
  933.        If you choose to install mailrm in some other place you must
  934.        be sure to supply full path names to all the required files
  935.        on the mailrm command line.
  936.  
  937.        9.3   Making _ the _ alias.dat _ file
  938.  
  939.              Mailrm needs to have some way of converting (or
  940.        mapping) PROCOMM mail recipient names to valid network
  941.        userids.  The alias.dat file contains a list of entries
  942.        which provide this information.  Alias.dat can be created
  943.        with any text editor (non-document mode).  You may find it
  944.        convenient to use the maillst utility program to start the
  945.        alias.dat creation process.  As described below, this
  946.        utility will scan the user accounts file on a specified
  947.        network mail server and will ensure that each network userid
  948.        has an entry in the alias file.
  949.  
  950.        9.3.1   Using _ the _ maillst.exe _ Program   See "Support Utilities
  951.        Section of this Document"
  952.  
  953.        9.3.2   Preventing _ Mail _ Forwarding _ for _ Certain _ Users   If the
  954.        network user id field of the alias.dat file contains the
  955.        letters "NOFWD" no PROCOMM to network forwarding will be
  956.        performed for the corresponding names.  Any PROCOMM users
  957.        who do NOT have accounts on the local area network should be
  958.        entered at the end of the alias.dat file with the NOFWD net
  959.        username field.
  960.  
  961.        9.4   Picking _ a _ mail _ server
  962.  
  963.              Mailrm attempts to perform mail forwarding between the
  964.        PROCOMM node and a network mail server.  The network must
  965.        have at least one machine capable of handling network mail
  966.        (ie the @MAIL resource must be defined on that machine).  On
  967.        large networks there can be more than one mail server.  (See
  968.        Special Notes for multiple mail server configurations).  For
  969.        each mail server to which you want mailrm to send/receive
  970.        mail perform the steps listed below.
  971.  
  972.        9.4.1   Creating _ a _ User _ Account _ For _ Mailrm   Follow the
  973.        procedure outlined in the LANtastic documentation to create
  974.        a network userid for mailrm.  Be sure to assign the "A" and
  975.        "M" privileges to this network userid.  The id you create
  976.        will be used in the steps below to define a login procedure
  977.        which allows mailrm to have access to the mail server
  978.        machine.  If a mail queue resource is not already defined
  979.        then create one following the procedure outlined in the
  980.        LANtastic documentation.
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                                   - 16 -
  995.  
  996.  
  997.  
  998.        9.4.2   Identifying _ the _ System _ Operator   Mailrm will provide
  999.        most of its feedback by sending e-mail to the network system
  1000.        operator.  This net user is identified by placing the name
  1001.        "sysop" as one of the fields in that net users alias.dat
  1002.        file entry. Thus...
  1003.  
  1004.                Joel    sysop joel smith
  1005.  
  1006.        in the alias.dat file will cause mailrm status messages to
  1007.        be mailed to the network user whose id is "Joel".
  1008.  
  1009.        9.5   Creating _ Your _ mailroom.bat _ File
  1010.  
  1011.              As previously noted, the PROCOMM aspect scripts are
  1012.        configured to automatically invoke a DOS batch file at
  1013.        certain times.  The defualt name for this file is
  1014.        "mailroom.bat".  Since running mailrm requires a number of
  1015.        steps, create the mailroom.bat file.  Once written,
  1016.        mailroom.bat can be manually invoked to test the
  1017.        installation prior to starting the automatic execution
  1018.        scripts.
  1019.  
  1020.             A sample mailroom.bat file is included in the
  1021.        distribution archive.  In general the steps to be performed
  1022.        in the batch file are..
  1023.  
  1024.          1.  If not already done, log into the network mail
  1025.              server(s) using the user ids previously created.
  1026.  
  1027.          2.  Execute the mailrm.exe program using the proper
  1028.              command line options
  1029.  
  1030.          3.  You may also wish to optionally execute the pcmail
  1031.              program with the "/c" option to compress the PROCOMM
  1032.              mail message database to remove any files which have
  1033.              been deleted.  DO NOT include the pcmail line if you
  1034.              need to preserve copies of deleted PROCOMM mail
  1035.              messages.  You SHOULD still manually compress the
  1036.              message datatbase periodically.
  1037.  
  1038.          4.  If you logged into the network mail server machine as
  1039.              the first step in the batch file, then be sure to log
  1040.              out as the last step.
  1041.  
  1042.        9.6   Testing _ the _ Initial _ Installation
  1043.  
  1044.              Once the alias.dat and mailroom.bat files have been
  1045.        properly configured and you have created a userid for mailrm
  1046.        on the network mail server, its time to test things.  A good
  1047.        first step is to use the PROCOMM pcmail.exe program to
  1048.        create a message to yourself.  Invoke the pcmail program and
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                                   - 17 -
  1061.  
  1062.  
  1063.  
  1064.        select the add message option.  Be sure to enter your proper
  1065.        network user name (or a valid alias for that name as defined
  1066.        in the alias.dat file) in the "To:" field.  For the message
  1067.        body just enter a short message for now.  At this point
  1068.        please make sure that PROCOMM is NOT running.  Invoke
  1069.        mailroom.bat and watch for any error messages.  Next log
  1070.        into the network mail server and check for mail.  You should
  1071.        see your message (plus possibly a lot more if there were
  1072.        several messages in the PROCOMM mail database).  If you did
  1073.        not inhibit the mailrm status report message there should
  1074.        also be mail to the system operator.  If you have the proper
  1075.        priviledges you (or your sysop) can read this status report
  1076.        to get a more detailed history of what mailrm did.
  1077.  
  1078.             If you enabled mailrm's return receipt feature then go
  1079.        back to pcmail and review the message database again.  There
  1080.        should be a new message from mailrm indicating the success
  1081.        or failure of the forwarding operation.
  1082.  
  1083.        9.7   Installing _ the _ Automatic _ Execution _ Scripts
  1084.  
  1085.              Once the mailroom.bat script has been tested, you might
  1086.        want to install one of the PROCOMM scripts.  The advantage
  1087.        of using the scripts is that mail will be more promptly
  1088.        forwarded  both immediately after each remote user logout
  1089.        and at a time interval which you can set.  In addition these
  1090.        scripts will ensure that mailrm.exe is not invoked while
  1091.        PROCOMM is in host mode.  The disadvantage is that somewhat
  1092.        more memory will be required on your PROCOMM node.  In
  1093.        addition use of the same line for dial out operations will
  1094.        be complicated since the script must be stopped and then
  1095.        restarted before/after the dial out session.  If you decide
  1096.        to use one of the scripts, simply make the changes
  1097.        previously described and invoke PROCOMM with the
  1098.        "/f<scriptname>" argument.
  1099.  
  1100.             If you elect not to use the script, it will be
  1101.        necessary for you or your system operator to manually run
  1102.        mailrm with some regularity.  Mail will not be forwarded
  1103.        between PROCOMM mail and the network or vice versa until
  1104.        mailrm is run.  When manually running mailrm, you must be
  1105.        SURE that PROCOMM is not running in host mode.  This
  1106.        consideration is especially important if you are running
  1107.        PROCOMM in a multitasking environment.  It is also dangerous
  1108.        to select the DOS shell option from within host mode and
  1109.        then run mailrm from the DOS shell.  Either of these methods
  1110.        will cause mailrm to run possibly changing the contents and
  1111.        lengths of the pcplus.msg and pcplus.hdr files while these
  1112.        files are in use by PROCOMM host mode.  This simultaneous
  1113.        use of the files will almost ensure corrupt mail files and
  1114.        potential loss of messages.
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.                                   - 18 -
  1127.  
  1128.  
  1129.  
  1130.        10.   Special _ Configurations
  1131.  
  1132.         10.1   Optimizing _ Performance
  1133.  
  1134.              Keep PROCOMM mail database small by regularly removing
  1135.        deleted messages Set the beep and popup delay time to zero
  1136.        for the mail server.  Run mailrm frequently.
  1137.  
  1138.        10.2   More _ than _ one _ mail _ server
  1139.  
  1140.              Support for this configuration will be provided in a
  1141.        future release.
  1142.  
  1143.             It is possible to use multiple mail servers with the
  1144.        current release provided that multiple network name alias
  1145.        files are setup.  To avoid lots of dead letters you must
  1146.        create a separate alias.dat file for each mail server.  Run
  1147.        mailrm once for each mail server (making sure you specify a
  1148.        different server and alias file each time).  The alias file
  1149.        for each server should have NOFWD entries for all valid
  1150.        users in the other servers.  This will ensure that erroneous
  1151.        deadletters are not created.
  1152.  
  1153.        10.3   More _ than _ one _ PROCOMM _ node
  1154.  
  1155.              Support for this configuration will be provided in a
  1156.        future release.
  1157.  
  1158.        10.4   Getting _ Help _ - _ Trouble _ Shooting _ - _ Adding _ Features
  1159.  
  1160.              The author will provide limited assistance over
  1161.        Compuserve.  You may send questions, comments, suggestions
  1162.        to 71611,2121.  If you would like to enhance mailrm's
  1163.        capabilities, source code with extensive comments is
  1164.        available for a modest registration fee (See beginning of
  1165.        this document).
  1166.  
  1167.             The best approach to trouble shooting is to first
  1168.        rigorously verify that both your PROCOMM installation and
  1169.        your LANtastic network mail system are operating properly.
  1170.        Once these two subsystems are working correctly you can
  1171.        isolate the nature of any problems by examining mailrm's
  1172.        screen displays and by looking at the status mail files
  1173.        which mailrm sends to the system operator.  Note that it is
  1174.        possible to inhibit both the mailrm screen output and sysop
  1175.        status mail via command line options.  When debugging make
  1176.        sure that you have not inhibited either source of feedback.
  1177.  
  1178.             Many mailrm problems can be traced to either
  1179.        insufficient RAM on the PROCOMM node or mailrm's inability
  1180.        to access files it needs to run.  If you don't have enough
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                   - 19 -
  1193.  
  1194.  
  1195.  
  1196.        RAM to contain PROCOMM, the mailrm.exe file, the Artisoft
  1197.        net.exe command, and a copy of command.com you cannot use
  1198.        the automatic execution scripts.  In these situations you
  1199.        can still use mailrm by first terminating PROCOMM.  File
  1200.        access problems are usually related to insufficient file
  1201.        handles (adjust your config.sys), bad filename arguments
  1202.        passed to mailrm on the command line, or network access
  1203.        permission problems.  Mailrm will usually identify the file
  1204.        it couldn't access either onscreen or in the sysop status
  1205.        message.  Failure to establish a login session with the
  1206.        desired mail server will cause mailrm to complain whenever
  1207.        it attempts to send mail messages or access any of the mail
  1208.        queue files.
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.